@jest/fake-timers

What is @jest/fake-timers?

@jest/fake-timers is a package that provides fake timer functions for Jest, a popular JavaScript testing framework. It allows you to control the passage of time in your tests, making it easier to test code that relies on timers, such as setTimeout, setInterval, and Date.

What are @jest/fake-timers's main functionalities?

Mocking setTimeout and setInterval

This feature allows you to mock setTimeout and setInterval functions, enabling you to control the passage of time in your tests. The code sample demonstrates how to use jest.useFakeTimers() to mock the timers and jest.advanceTimersByTime() to fast-forward time.

const { jest } = require('@jest/globals');

jest.useFakeTimers();

setTimeout(() => {
  console.log('This will be logged after 1 second');
}, 1000);

jest.advanceTimersByTime(1000); // Fast-forward time by 1 second

// Output: 'This will be logged after 1 second'

Mocking Date

This feature allows you to mock the Date object, enabling you to control the current date and time in your tests. The code sample demonstrates how to use jest.useFakeTimers('modern') to mock the Date object and jest.setSystemTime() to set a specific date and time.

const { jest } = require('@jest/globals');

jest.useFakeTimers('modern');

const now = Date.now();
console.log(now); // Outputs the current timestamp

jest.setSystemTime(new Date('2020-01-01'));

const newNow = Date.now();
console.log(newNow); // Outputs the timestamp for 2020-01-01

Clearing timers

This feature allows you to clear mocked timers, ensuring that the associated callbacks are not executed. The code sample demonstrates how to use clearTimeout() to clear a setTimeout timer.

const { jest } = require('@jest/globals');

jest.useFakeTimers();

const timeoutId = setTimeout(() => {
  console.log('This will not be logged');
}, 1000);

clearTimeout(timeoutId);

jest.advanceTimersByTime(1000); // Fast-forward time by 1 second

// No output

Other packages similar to @jest/fake-timers

sinon

Sinon is a popular standalone test spies, stubs, and mocks library for JavaScript. It provides similar functionalities to @jest/fake-timers, including the ability to mock timers and control the passage of time. However, Sinon is not tied to any specific testing framework and can be used with various testing libraries.

lolex

Lolex is a standalone library for creating fake timers and controlling the passage of time. It provides similar functionalities to @jest/fake-timers, such as mocking setTimeout, setInterval, and Date. Lolex can be used independently or integrated with other testing frameworks.

README

The README file is missing

Changelog

26.6.2

Features

• [jest-core] Add findRelatedTests and nonFlagArgs in allowed config options for updateConfigAndRun in watch plugins (#10659)

Fixes

• [babel-plugin-jest-hoist] Preserve order of hoisted mock nodes within containing block (#10536)
• [babel-plugin-jest-hoist] Hoist pure constants to support experimental JSX transform in hoisted mocks (#10723)
• [babel-preset-jest] Update babel-preset-current-node-syntax to support top level await (#10747)
• [expect] Revert "Fix objectContaining to work recursively into sub-objects (#10508)" (#10766)
• [jest-circus, jest-jasmine2] fix: don't assume stack is always a string (#10697)
• [jest-config] Fix bug introduced in watch mode by PR #10678 (#10692)
• [jest-config] Throw correct error for missing preset modules (#10737)
• [jest-resolve-dependencies] Resolve mocks as dependencies (#10713)
• [jest-runtime] Handle file URLs in dynamic imports (#10744)
• [jest-runtime, babel-jest] Pass more ESM options to @jest/transform (#10752)
• [jest-runtime] Properly inject extraGlobals into the runtime (#10758)
• [jest-transform] Link to ESM docs on syntax errors (#10748)

Chore & Maintenance

• [docs] Add docs for using mocks in TypeScript (#10415)
• [eslint-config-fb-strict] Move package from this repo to fbjs repo (#10739)
• [examples] Update TypeScript example to show use of newer Jest types (#10399)
• [jest-cli] chore: standardize files and folder names (#10698)
• [jest-config] Switch ts-node Register type to Service due to deprecation (#11210)